<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>Troubleshooting | OpenIntelWireless</title>
    <meta name="generator" content="VuePress 1.8.2">
    <link rel="icon" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/favicon.png">
    <link rel="apple-touch-icon" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/favicon.png">
    <meta name="description" content="Documentation for OpenIntelWireless Products">
    
    <link rel="preload" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/css/0.styles.38ece107.css" as="style"><link rel="preload" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/app.85ea9f6d.js" as="script"><link rel="preload" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/2.b0f34ab6.js" as="script"><link rel="preload" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/26.660dfc86.js" as="script"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/10.95f1b639.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/11.f459fb2c.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/12.0092fe0f.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/13.11e4a1ba.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/14.4b655f34.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/15.8468005e.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/16.978c774e.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/17.6b396722.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/18.33beea2f.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/19.a5de10d1.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/20.5aae36d5.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/21.b12cee2f.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/22.a11d3543.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/23.054be642.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/24.197b77cc.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/25.a8d9d5a8.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/3.5d3f47eb.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/4.73e28535.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/5.6d8defb9.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/6.279a7608.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/7.cb52124a.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/8.5c1154d0.js"><link rel="prefetch" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/9.8fa7de31.js">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/css/0.styles.38ece107.css">
  </head>
  <body>
    <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><!----> <span class="site-name">OpenIntelWireless</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/General/Installation.html" class="nav-link">
  General
</a></div><div class="nav-item"><a href="/itlwm/" class="nav-link router-link-active">
  itlwm
</a></div><div class="nav-item"><a href="/HeliPort/" class="nav-link">
  HeliPort
</a></div><div class="nav-item"><a href="/IntelBluetoothFirmware/" class="nav-link">
  IntelBluetoothFirmware
</a></div> <a href="https://github.com/OpenIntelWireless" target="_blank" rel="noopener noreferrer" class="repo-link">
    Visit Us On GitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><a href="/General/Installation.html" class="nav-link">
  General
</a></div><div class="nav-item"><a href="/itlwm/" class="nav-link router-link-active">
  itlwm
</a></div><div class="nav-item"><a href="/HeliPort/" class="nav-link">
  HeliPort
</a></div><div class="nav-item"><a href="/IntelBluetoothFirmware/" class="nav-link">
  IntelBluetoothFirmware
</a></div> <a href="https://github.com/OpenIntelWireless" target="_blank" rel="noopener noreferrer" class="repo-link">
    Visit Us On GitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav>  <ul class="sidebar-links"><li><a href="/itlwm/" aria-current="page" class="sidebar-link">itlwm</a></li><li><a href="/itlwm/Installation.html" class="sidebar-link">Installation</a></li><li><a href="/itlwm/Compat.html" class="sidebar-link">Compatibility</a></li><li><a href="/itlwm/FAQ.html" class="sidebar-link">Frequently Asked Questions</a></li><li><a href="/itlwm/Troubleshooting.html" aria-current="page" class="active sidebar-link">Troubleshooting</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/itlwm/Troubleshooting.html#kernel-extension-loading-status" class="sidebar-link">Kernel Extension Loading Status</a></li><li class="sidebar-sub-header"><a href="/itlwm/Troubleshooting.html#resetting-system-preferences-network" class="sidebar-link">Resetting System Preferences - Network</a></li><li class="sidebar-sub-header"><a href="/itlwm/Troubleshooting.html#runtime-logs" class="sidebar-link">Runtime Logs</a></li></ul></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="troubleshooting"><a href="#troubleshooting" class="header-anchor">#</a> Troubleshooting</h1> <p>Troubleshooting a Kernel Extension might not be straight forward, here are some tactics:</p> <h2 id="kernel-extension-loading-status"><a href="#kernel-extension-loading-status" class="header-anchor">#</a> Kernel Extension Loading Status</h2> <p>Run the following command in terminal:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code>kextstat <span class="token operator">|</span> <span class="token function">grep</span> -i <span class="token string">&quot;KEXT'S_NAME&quot;</span>
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>For example:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code>$ kextstat <span class="token operator">|</span> <span class="token function">grep</span> -i <span class="token string">&quot;itlwm&quot;</span>
    <span class="token number">70</span>    <span class="token number">0</span> 0xffffff7f84126000 0xf86000   0xf86000   com.zxystd.itlwm <span class="token punctuation">(</span><span class="token number">1</span><span class="token punctuation">)</span> 10EA7641-BDCB-3820-9AF7-4C773FD9953E <span class="token operator">&lt;</span><span class="token number">33</span> <span class="token number">13</span> <span class="token number">6</span> <span class="token number">5</span> <span class="token number">3</span> <span class="token operator"><span class="token file-descriptor important">1</span>&gt;</span>
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><ul><li>If a new line with the kext's name appears, it means the kext has successfully loaded.</li> <li>If you get nothing, please recheck your bootloader's configuration.</li></ul> <h2 id="resetting-system-preferences-network"><a href="#resetting-system-preferences-network" class="header-anchor">#</a> Resetting System Preferences - Network</h2> <p>If you've tried other network-related Kernel Extensions before, some system configurations may be corrupted.</p> <p><strong>WARNING:</strong> The following procedures will completely reset your network preferences, including proxies, DNS, etc. The deleted files will be automatically created. <em><strong>But make sure you have made a proper backup.</strong></em></p> <ol><li><p>Open System Preferences → Network, delete all ports, click on apply at the bottom right corner</p></li> <li><p>Open Terminal, run:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token function">open</span> /Library/Preferences/SystemConfiguration
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>Then Delete</p> <ul><li><strong><code>com.apple.airport.preferences.plist</code></strong></li> <li><strong><code>preferences.plist</code></strong></li> <li><strong><code>NetworkInterfaces.plist</code></strong></li> <li><strong><code>com.apple.network.identification.plist</code></strong></li> <li><strong><code>com.apple.wifi.message-tracer.plist</code></strong></li> <li>And all files containing <code>enX</code>, (<code>X</code> as an integer)</li></ul> <blockquote><p>If you've changed your SMBIOS before, you must also delete files with names that contain your current and previous models.</p></blockquote></li> <li><p>Reboot</p></li></ol> <h2 id="runtime-logs"><a href="#runtime-logs" class="header-anchor">#</a> Runtime Logs</h2> <p>Choose one of the following methods to collect logs</p> <h3 id="via-heliport"><a href="#via-heliport" class="header-anchor">#</a> Via HeliPort</h3> <p><a href="/HeliPort/Troubleshooting.html">Use HeliPort to create a diagnostic report</a> (works for AirportItlwm as well)</p> <h3 id="manually-collecting-logs"><a href="#manually-collecting-logs" class="header-anchor">#</a> Manually Collecting Logs</h3> <ol><li><p>Install <a href="https://github.com/acidanthera/DebugEnhancer" target="_blank" rel="noopener noreferrer"><code>DebugEnhancer.kext</code><span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p></li> <li><p>For AirportItlwm users, run the following commands <em><strong>before</strong></em> the next step</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token comment"># Enable airportd logs</span>
<span class="token function">sudo</span> /System/Library/PrivateFrameworks/Apple80211.framework/Versions/A/Resources/airport debug +AllUserland +AllDriver +AllVendor
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li> <li><p>Run the following commands in terminal to gather logs:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token function">sudo</span> <span class="token function">dmesg</span> <span class="token operator">|</span> <span class="token function">grep</span> -E <span class="token string">&quot;itlwm|Airport|IO80211|EAPOL&quot;</span> <span class="token operator">&gt;</span> ~/Desktop/Log_<span class="token string">&quot;<span class="token variable"><span class="token variable">$(</span><span class="token function">date</span> <span class="token string">'+%Y-%m-%d_%H-%M-%S'</span><span class="token variable">)</span></span>&quot;</span>.log
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>A log file will then be created on your Desktop.</p></li></ol> <h3 id="debugging-802-1x"><a href="#debugging-802-1x" class="header-anchor">#</a> Debugging 802.1X</h3> <p>If you are using a network with 802.1X, please follow the guide below provided by Apple.</p> <h4 id="enabling-logging"><a href="#enabling-logging" class="header-anchor">#</a> Enabling Logging</h4> <ol><li><p>Enable 802.1X verbose logs by running the below command in the terminal:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token function">sudo</span> wdutil log +wifi +eapol
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>Reproduce the problem. (Important: Note the date and time issue occurred add this information to your report).</p></li> <li><p>Then gather wireless diagnostics by running the below command in the terminal:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token function">sudo</span> wdutil diagnose
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>Attach the wireless diagnostic file that appears in <code>/private/var/tmp/</code> after several minutes.</p> <p><strong>Note:</strong> The wireless diagnostic process can take 10 minutes to complete. Once finished, the folder “/private/var/tmp/“ should appear automatically in the Finder and the wireless diagnostic file there will look similar to this: <code>WirelessDiagnostics_C02T21XYZPDQ_2021-02-22_10.24.48.tar.gz</code></p></li></ol> <h4 id="disabling-logging-to-disable-eapol-logging"><a href="#disabling-logging-to-disable-eapol-logging" class="header-anchor">#</a> Disabling Logging To disable EAPOL logging</h4> <p>To disable both Wi-Fi and EAPOL logging use:</p> <div class="language-sh line-numbers-mode"><pre class="language-sh"><code><span class="token function">sudo</span> wdutil log -wifi -eapol
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></div> <footer class="page-edit"><!----> <!----></footer> <div class="page-nav"><p class="inner"><span class="prev">
      ←
      <a href="/itlwm/FAQ.html" class="prev">
        Frequently Asked Questions
      </a></span> <!----></p></div> </main></div><div class="global-ui"></div></div>
    <script src="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/app.85ea9f6d.js" defer></script><script src="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/2.b0f34ab6.js" defer></script><script src="https://cdn.jsdelivr.net/gh/OpenIntelWireless/OpenIntelWireless.github.io@master/assets/js/26.660dfc86.js" defer></script>
  </body>
</html>
